|
|
XPages Extension LibraryのDojo Number Spinnerの機能および利用方法について説明します
|
ShowTable of Contents
XPages Extension Library「Dojo Number Spinner」の機能および利用方法について説明します。
テキストボックスの右側に数字をカウントアップ/ダウンさせるボタンがあり、マウスのクリックだけで数値の入力を促すことが出来るコントロールです。
テキストボックス上でマウススクローラーを上下させることでも数値を増減させることが出来るようになります。
このコントロールのタグは xe:djNumberSpinner です。
<xe:djNumberSpinner id="djNumberSpinner1"></xe:djNumberSpinner>
Dojo Number Spinnerで使用する主なプロパティ
|
カテゴリ
|
プロパティ
|
説明
|
|
データ
|
constraints
|
数値の制限を設定します
|
|
|
defaultValue
|
デフォルトの値を設定します
|
|
|
disableClientSideValidation
|
(この値は無視されます)
|
|
|
disableModifyFlag
|
このコントロールが現在のXPagesの編集通知機能に追加されることを無効にします
|
|
|
disableValidators
|
このコントロールにアサインされた有効化チェックを無効にします
|
|
|
invalidMessage
|
このフィールドが無効であった場合に表示されます
|
|
|
javaType
|
サーバーサイドによって変換され返される値の数値の型を指定します。もしなにも設定されていない場合はDouble型が利用されます
|
|
|
largeDelta
|
「Page Up」「Page Down」のキーを利用された場合の数値の増減数を指定します。 デフォルトでは１０です
|
|
|
promptMessage
|
このフィールドがフォーカスされた時に表示されるヒントのメッセージです
|
|
|
rangeMessage |
入力された数値がレンジ外の値出会った場合に表示されるメッセージです |
|
|
regExp |
有効化チェックのために利用する正規化表現を記入します。「regExpGen」を利用する場合は、このプロパティは使用しないでください。
もしなにも入力されていない場合は、正規化表現として".*"が利用されます。
|
|
|
regExpGen |
このプロパティはConstraintsで定義された有効化チェックを上書きすることを意味します。 ダイナミックに有効化チェックを行なう場合に効果的です。
「regExp」を利用する場合は、このプロパティは使用しないでください。
|
|
|
showReadonlyAsDisabled |
|
|
|
smallDelta |
上下のカーソルキーまたはボタンをクリックした時に増減する値を指定します。 |
|
|
validator |
|
|
|
validators |
|
|
|
value |
フィールドとバインドするデータを設定します |
|
|
valueChangeListener |
|
|
|
valueChangeListeners |
|
Dojo Number Spinnerの使用例
「constraints」プロパティを利用して数値の制限を0～20に制限してあります。
サンプルの XPage ソースコード
テストのため、実際のフィールドとデータバインドはせず、sessionScopeの変数に値が保持されるコードになっています。
<xe:djNumberSpinner id="djNumberSpinnerCarTypeNormal"
value="#{sessionScope.djTestValue}" defaultValue="0"
javaType="int" invalidMessage="入力の数値は無効です" promptMessage="数値を入力してください"
rangeMessage="入力された値は許可された数値の範囲外です" largeDelta="5" smallDelta="2">
<xe:this.constraints>
<xe:djNumberConstraints min="0" max="20" places="0" type="decimal">
</xe:djNumberConstraints>
</xe:this.constraints>
</xe:djNumberSpinner>
調査環境
Lotus Notes/Domino 9 + Extension Library
|